home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / sf102.zip / SF.DOC < prev    next >
Text File  |  1990-01-25  |  14KB  |  326 lines
  1.                 ╔════════════════════════════╗
  2.                 ║   SF - ShowFiles  V1.2     ║
  3.                 ║   Copyright (C) 1989, 1990 ║
  4.                 ║   Irvine Data Systems      ║
  5.                 ╚════════════════════════════╝
  6.  
  7.  
  8.   SF  is  a  shareware product. As such, feel free  to  copy  and
  9. distribute it as often as you like provided that:
  10.   1)  This  document  file and the  SF  executable  are  supplied
  11.       unaltered.
  12.   2)  No fee is charged for duplication.
  13.  
  14.   If you find this product to be useful and would like to  become
  15. a registered user, please send a $15 donation.
  16.  
  17.   If  you  are using this product in a commercial  or  government
  18. organization then a $15 donation is required.  Site licenses  and
  19. distribution licenses are available, write for more information.
  20.  
  21.   Michael Irvine
  22.   Irvine Data Systems
  23.   3225 Coquelin Terrace
  24.   Chevy Chase,  MD  20815
  25.  
  26. (Make checks payable to Michael Irvine)
  27.  
  28.   If you would like a customized version of this product, send  a
  29. description  of the modifications you would like and  your  name,
  30. address,  and a telephone number to the address above.  Or,  call
  31. (301) 593-1563 to discuss the modifications on the phone.
  32.  
  33. _________________________________________________________________
  34.  
  35.  
  36.   All  SF  options  are toggled by specifying the  command  as  a
  37. parameter on the command line.
  38.  
  39. Syntax: SF [filemask] [options]
  40.  
  41. Filemask:
  42.   The filemask is a filename or list of filenames which may be or
  43. contain wildcards.  The first filename may have a drive and  path
  44. specified  but subsequent filnames may not.  Filenames in a  list
  45. should be separated by commas. SF (unlike DOS) will allow for  up
  46. to  eight  asterisks for a name and three for an  extension.   An
  47. asterisk  represents any string even a null string. The  question
  48. mark represents any character.
  49.  
  50.   For Example:
  51.     SF *HI*.?
  52.   Would  list all files with an 'HI' somewhere in the  name  that
  53.   have a one character extension.
  54.  
  55.     SF D:\*.bat, *.exe, *.com
  56.   Would  list  all  files  which have a .bat,  .exe,  or  a  .com
  57.   extension.
  58.  
  59. Options:
  60.   When  specifying  options,  the first option  in  each  set  of
  61. options must be preceded by a '-' but following options need  not
  62. be.   In addition,  it does not matter if the filemask is  placed
  63. before  or  after or even between  sets of options as long  as  a
  64. space separates it from the options.
  65.  
  66.   For example:
  67.     SF -HST D:\*.* -X[copy @ a:]RF
  68.  
  69. SF command options:
  70.  
  71. Command:  Default:
  72.       -L        On    Generate a long listing which consists of a
  73.                       file  or directory name, a size, a date,  a
  74.                       time,   and   an  attribute   listing.   In
  75.                       addition,   header  and  size  totals   are
  76.                       displayed for each directory. This command,
  77.                       when turned off, will toggle the  following
  78.                       options:
  79.                          Header hisplay
  80.                          File size display
  81.                          Size totals
  82.                          Last file modification time display
  83.                          Directory names display
  84.                          File path display
  85.                          File attribute display
  86.  
  87.       -H        On    Display  a header for the  directory  which
  88.                       consists   of  the  path  currently   being
  89.                       searched, and the filemask.
  90.  
  91.       -S        On    Display the size of all files listed.
  92.  
  93.       -T        On    Display  the  size totals for  all  of  the
  94.                       entries  listed if a directory. At  present
  95.                       these  are  not rounded up  to  the  disk's
  96.                       cluster size.
  97.  
  98.       -W        On    Display   the   date  and  time   of   last
  99.                       modification for all files listed.
  100.  
  101.       -N        On    Display directory names.  Good for  getting
  102.                       directory  listings  without files  or  for
  103.                       file listings without directory names.
  104.  
  105.       -O        On    Display  filenames.  Good for getting  file
  106.                       listings   without   directory   names   or
  107.                       directory listings without filenames.
  108.  
  109.       -A        On    Display   the  attributes  for  each   file
  110.                       listed.
  111.  
  112.       -F        On    Display  filenames  before  displaying  any
  113.                       other  information  about the  file.   When
  114.                       turned  off, filenames are displayed  after
  115.                       any  other  information  requested.    This
  116.                       results in a left justified listing.
  117.  
  118.       -P       Off    For each file or directory listed,  display
  119.                       its full drive, path, and name.
  120.  
  121.       -I       Off    Indent  directory listings to  reflect  the
  122.                       depth  of  the  directory  currently  being
  123.                       searched,  relative  to the  directory  the
  124.                       search was started on.
  125.  
  126.       -R       Off    Look  through all of the  directories  that
  127.                       are   contained   within   the    directory
  128.                       currently being searched.
  129.  
  130.       -X       Off    For  each  file in the listing,  execute  a
  131.                       specified  program  or  DOS  command.   The
  132.                       command  must be placed in  square  braces.
  133.                       In  addition, any of the following  may  be
  134.                       placed in the command and will replaced  at
  135.                       execution  time with information  from  the
  136.                       file currently being listed as follows:
  137.  
  138.                         @  = drive:directory\name.ext
  139.                         @p = drive:directory
  140.                         @n = name
  141.                         @e = .ext
  142.                         @f = name.ext
  143.  
  144.                       For example:
  145.                         SF -X[copy @ D:]
  146.                       Would  copy  each  file listed  to  the  D:
  147.                       drive.
  148.  
  149.       -K        On    If the -X option is on, then query the user
  150.                       before executing the specified command.
  151.                       *** Note: It would be a good idea to  leave
  152.                       this  option on if you wish to  avoid  data
  153.                       loss while executing some commands.
  154.  
  155.       -V  None set    Avoid  a set of patterns. Where the set  is
  156.                       enclosed by square braces.
  157.  
  158.                       For example:
  159.                         SF D:\*.* -X[*.bat, *.pas, *.asm]
  160.                       Would  list all files in the D:\  directory
  161.                       that  did not have the extentions  of  BAT,
  162.                       PAS, or ASM.
  163.  
  164.       -C  None set    Define  a character to be any of a  set  of
  165.                       other characters. Where the wild  character
  166.                       follows the -C on the command line and  the
  167.                       set  of  characters is enclosed  in  square
  168.                       braces. Note: This is case sensitive.
  169.  
  170.                       For example:
  171.                         SF D:\*.&&& -C&[BTA]
  172.                       Would  list all files in the D:\  directory
  173.                       which  have the extentions of :  BTA,  ATB,
  174.                       TBA, BAT, ATB, TBA.
  175.  
  176.       -D         [    Set  the  character that acts as  the  left
  177.                       brace  to  a new character. Where  the  new
  178.                       left brace character follow the -D.
  179.  
  180.                       For example:
  181.                         SF D:\*.* -D{E}C&{BTA}
  182.                       Would allow for different characters to  be
  183.                       used for the braces in the example for  the
  184.                       -C command.
  185.  
  186.       -E         ]    Set  the character that acts as  the  right
  187.                       brace  to  a new character. Where  the  new
  188.                       right brace character follows the -E.
  189.  
  190.                       For example:
  191.                         SF D:\*.* -D{E}C&{BTA}
  192.